You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

Issue Linking Reminder

This PR doesn't appear to have a linked issue. Consider linking to:

• This repo: Closes #123
• ralph-ideas: Closes multivmlabs/ralph-ideas#123

Using Closes, Fixes, or Resolves will auto-close the issue when this PR is merged.

If this PR doesn't need an issue, you can ignore this message.

✔️ Bundle Size Analysis

156K	dist/auth
80K	dist/automation
4.0K	dist/cli.d.ts
4.0K	dist/cli.d.ts.map
20K	dist/cli.js
16K	dist/cli.js.map
640K	dist/commands
28K	dist/config
4.0K	dist/index.d.ts
4.0K	dist/index.d.ts.map
4.0K	dist/index.js
4.0K	dist/index.js.map
916K	dist/integrations
100K	dist/llm
1.2M	dist/loop
188K	dist/mcp
60K	dist/presets
92K	dist/setup
40K	dist/skills
392K	dist/sources
76K	dist/ui
144K	dist/utils
336K	dist/wizard

🔗 Docs Preview

Preview URL: https://feat-linear-integration-wiza.ralph-starter-docs.pages.dev

This preview was deployed from the latest commit on this PR.

Greptile Summary

This PR introduces an interactive Linear issues wizard (ralph-starter linear) that guides users through authenticating, selecting a team/project, and picking an issue before delegating to runCommand. It also adds shared wizard utilities (src/integrations/wizards/shared.ts) reusable across future integrations, and wires up a fallback so ralph-starter run --from linear (without --project) automatically launches the wizard.

Key changes:

• src/commands/linear.ts — Full wizard implementation with GraphQL team/project/issue fetching, URL parsing, and priority display
• src/integrations/wizards/shared.ts — Reusable ensureCredentials, askBrowseOrUrl, and askForUrl helpers
• src/commands/run.ts — Wizard fallback via dynamic import when --from linear is used without --project/--issue
• src/cli.ts — Command registration matching the figma wizard pattern

Issues found:

• Multiple interface declarations (LinearWizardOptions, LinearTeam, LinearProject, LinearIssue, and CredentialOptions) should be type per project conventions

Confidence Score: 4/5

• Safe to merge after fixing minor style convention issue with type vs interface declarations.
• The PR implements a well-structured Linear wizard with proper architecture, correct fallback logic, and solid reusable utilities. The only issue is a style convention violation: several simple data structure declarations use interface instead of type as specified in the project's custom rules. This is a minor cosmetic issue that doesn't affect runtime behavior and is straightforward to fix.
• src/commands/linear.ts and src/integrations/wizards/shared.ts need style updates to use type instead of interface for simple data structures.

Sequence Diagram

sequenceDiagram
    actor User
    participant CLI as ralph-starter CLI
    participant LinearCmd as linearCommand
    participant Shared as shared.ts (ensureCredentials)
    participant LinearAPI as Linear GraphQL API
    participant RunCmd as runCommand

    User->>CLI: ralph-starter linear [options]
    CLI->>LinearCmd: linearCommand(options)

    LinearCmd->>Shared: ensureCredentials('linear', ...)
    alt CLI authenticated
        Shared-->>LinearCmd: '__cli_auth__'
        LinearCmd->>LinearCmd: getLinearApiKey()
    else Credentials in config/env
        Shared-->>LinearCmd: apiKey
    else No credentials
        Shared->>User: Prompt for API key
        User-->>Shared: API key input
        Shared-->>LinearCmd: saved apiKey
    end

    LinearCmd->>User: Browse or paste URL?
    alt URL mode
        User-->>LinearCmd: linear.app/…/issue/TEAM-123
        LinearCmd->>LinearCmd: parseLinearUrl(url)
        LinearCmd->>RunCmd: runCommand(identifier, {from:'linear', project:teamKey})
    else Browse mode
        LinearCmd->>LinearAPI: GetTeams query
        LinearAPI-->>LinearCmd: teams[]
        LinearCmd->>User: Select team
        User-->>LinearCmd: selectedTeam

        LinearCmd->>User: Project / All issues / Specific ID?

        alt Project mode
            LinearCmd->>LinearAPI: GetProjects(teamId)
            LinearAPI-->>LinearCmd: projects[]
            LinearCmd->>User: Select project
        end

        LinearCmd->>LinearAPI: GetIssues(filter, first:30)
        LinearAPI-->>LinearCmd: issues[]
        LinearCmd->>User: Select issue
        User-->>LinearCmd: selectedIssue

        LinearCmd->>RunCmd: runCommand(selectedIssue, {from:'linear', project:teamKey})
    end

    RunCmd-->>User: Build loop starts

_{Last reviewed commit: 549bb51}

This PR has been automatically marked as stale because it has not had recent activity.
It will be closed in 7 days if no further activity occurs.
Please update or comment if this PR is still in progress.